Skip to content

doc: add macOS Arm runnable build notes#753

Closed
moreaki wants to merge 3 commits into
VirtualBox:mainfrom
moreaki:agent/darwin-arm-runnable-build-docs
Closed

doc: add macOS Arm runnable build notes#753
moreaki wants to merge 3 commits into
VirtualBox:mainfrom
moreaki:agent/darwin-arm-runnable-build-docs

Conversation

@moreaki

@moreaki moreaki commented Jul 8, 2026 •
edited
Loading

Copy link
Copy Markdown

Summary

Add doc/technical/DarwinArmRunnableBuild.wiki with a local macOS/Arm runnable-build workflow.

The note covers:

  • non-hardened OSE configure shape for local developer builds;
  • Xcode SDK/tool overrides for selected host-side targets when Oracle-style bundled tool trees are not present;
  • staging a runnable VirtualBox.app copy for local testing;
  • refreshing a rebuilt dylib into the staged app;
  • signing order for changed Mach-O images, nested VM bundles and the outer app;
  • local VM entitlement choices and release-only entitlements to avoid in ordinary local test signing.

Why

This workflow is currently easy to reconstruct incorrectly from configure output, kBuild variables and Darwin installer signing logic. A short technical note makes host-side macOS/Arm iteration more reproducible without changing packaging or release-signing behavior.

Validation

  • Documentation-only change.
  • git diff --check

Closes #751.

@moreaki
doc: add macOS Arm runnable build notes
5b5640a 
Document a local macOS/Arm workflow for configuring, building selected host-side targets, staging a runnable app bundle, and applying the signing order and entitlement choices needed for developer testing.

This is explicitly a local non-packaging workflow and leaves the Darwin installer and release signing paths unchanged.

Signed-off-by: Roberto Nibali <rnibali@gmail.com>
@oracle-contributor-agreement

oracle-contributor-agreement Bot commented Jul 8, 2026

Copy link
Copy Markdown

Thank you for your pull request and welcome to our community! To contribute, please sign the Oracle Contributor Agreement (OCA).
The following contributors of this PR have not signed the OCA:

To sign the OCA, please create an Oracle account and sign the OCA in Oracle's Contributor Agreement Application.

When signing the OCA, please provide your GitHub username. After signing the OCA and getting an OCA approval from Oracle, this PR will be automatically updated.

If you are an Oracle employee, please make sure that you are a member of the main Oracle GitHub organization, and your membership in this organization is public.

@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Required At least one contributor does not have an approved Oracle Contributor Agreement. label Jul 8, 2026
@moreaki moreaki mentioned this pull request Jul 8, 2026
Open
moreaki added 2 commits July 9, 2026 01:03
@moreaki
doc: mention Homebrew Qt libexec tools
12193cd 
Signed-off-by: Roberto Nibali <rnibali@gmail.com>
@moreaki
doc: prefer stable signing for local runs
0cc0945 
Signed-off-by: Roberto Nibali <rnibali@gmail.com>
@moreaki moreaki force-pushed the agent/darwin-arm-runnable-build-docs branch from 9371375 to 0cc0945 Compare July 9, 2026 07:43
@moreaki

moreaki commented Jul 16, 2026

Copy link
Copy Markdown
Author

Withdrawing this documentation PR until its prerequisites land. Re-running the documented commands showed that current main does not produce the claimed runnable GUI result: Homebrew Qt configuration needs #747, the generated environment needs #752, and VBoxDxMt needs the narrowed #748 build fix. The documentation should be recreated and tested end-to-end after those changes are available.

@moreaki moreaki closed this Jul 16, 2026
@moreaki moreaki mentioned this pull request Jul 16, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

OCA Required At least one contributor does not have an approved Oracle Contributor Agreement.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Document local macOS/Arm runnable build workflow

1 participant

@moreaki